auth add

認証情報を API 検証なしでキーチェーンに直接保存します。

cos auth login がネットワーク疎通確認を行うのに対して、auth add はオフラインで登録できます。CI 環境や自動化スクリプト向けです。

書式

cos auth add --type <sid|pat|sa> [--key <value> | --key-env <ENV> | --key-stdin] [--profile <name>] [--project <name>] [--set-default]

フラグ

--type <value> — 認証方式 (sid / pat / sa)

--key <value> — 認証キーの値を直接指定する

--key-env <ENV_NAME> — 環境変数名を渡し、その変数の値を使う (CI フレンドリー)

--key-stdin — stdin から認証キーを読み取る (末尾改行は自動 trim)

--profile <name> — 保存先プロファイル名 (デフォルト: default)

--project <name> — SA キー登録時のプロジェクト名 (type=sa 必須)

--set-default — 保存後に config.defaultProfile を更新する

入力モード (排他)

--key / --key-env / --key-stdin のいずれか 1 つを指定します。

使用例

code:bash

# SID を直接指定して保存

cos auth add --type sid --key "s%3Axxxxxxxx..." --profile 個人

# PAT を環境変数経由で保存 (argv に secret を露出させない CI 向け)

cos auth add --type pat --key-env MY_PAT_TOKEN --profile ci-readonly

# SA Key を stdin から読み込んでデフォルトプロファイルに設定

echo "cs_xxxx..." | cos auth add --type sa --key-stdin --project myproject --set-default

# シークレット管理ツールから渡す例

vault read -field=sid secret/cosense | cos auth add --type sid --key-stdin --profile prod